Olá, como podemos ajudar?

Pesquisas recentes: Configuração - 2.2.3 - Formulário - 2.2.3 - Data lab - 2.2.3 - Analytics - 2.2.3

Configurar importação de e-mail

 

Pré-requisitos

  • Tipo de workflow configurado.
  • Acesso ao menu Configuração > Importação de e-mail (WF015).

 

Apresentação

A importação consiste na captura de todos os e-mails enviados para uma determinada conta.

Conforme o que for configurado na importação, é possível agendar a inicialização de workflows a partir dos e-mails.

No SoftExpert Workflow, a importação de e-mail é configurada no menu Configuração > Importação de e-mail (WF015).

Veja como realizar esta configuração:

 

Configurar importação de e-mail

1. Acesse o menu Configuração > Importação de e-mail (WF015) e clique no botão da barra de ferramentas.

2. Na tela de dados que será apresentada, informe um identificador e um nome para o agendamento.

3. Preencha os campos requeridos da aba Geral:

  • Início: Informe a data e a hora de início da execução do agendamento.

4. Clique em . Neste momento, as demais abas serão habilitadas.

5. Preencha os campos na ordem das abas apresentadas na tela de agendamento:

Geral

Próxima execução

A data e a hora da próxima execução do agendamento são preenchidas conforme as informações de recorrência que serão preenchidas a seguir.

 

Recorrência

Configure a periodicidade da execução do agendamento:

 

Frequência: Selecione a frequência em que a execução do agendamento será realizada:

  • Sem recorrência: A execução do agendamento será feita somente uma vez, ou seja, não terá repetição.
  • Hora(s)/Minuto(s): A execução do agendamento será feita em intervalo de horas ou minutos. Informe, no campo "a cada __ hh:mm", o intervalo desejado. Por exemplo: a cada 01:15, a cada 00:30, a cada 03:00, etc. Obs.: Não será possível selecionar um tempo inferior a 15 minutos para o agendamento.
  • Diário: A execução do agendamento será feita em intervalo de dias. Informe, no campo "a cada __ dia(s)", o intervalo desejado. Por exemplo: a cada 2 dias, a cada 5 dias, etc.
  • Semanal: A execução do agendamento será feita em dias específicos da semana. No campo "Dias da semana", marque os dias nos quais a execução do agendamento deverá ser realizada. Por exemplo: toda segunda-feira, quarta-feira e sexta-feira.
  • Mensal: A execução do agendamento será feita em determinados meses do ano. No campo "Meses", marque os meses em que a execução do agendamento deverá ser realizada.

 

Término da recorrência: Selecione neste campo como será o término da recorrência da execução do agendamento:

  • Sem data de término: A recorrência da execução do agendamento não terá fim definido.
  • Termina após: A execução do agendamento termina após determinado número de ocorrências. Informe, no campo "Ocorrências", a quantidade limite de ocorrências  de execuções do agendamento.
  • Termina em: A execução do agendamento termina em uma determinada data. Selecione, no campo "Data", o dia, mês e ano em que a execução do agendamento terminará.

 

Excluir ao finalizar agendamento

Marque esta opção para que o registro seja excluído após o término da execução do agendamento.

 
 

Configuração

Servidor de e-mail

  • Protocolo: Selecione o protocolo a ser utilizado pelo servidor. O protocolo IMAP é o mais recomendado por permitir manter as mensagens no servidor apenas marcando-as como lidas. O protocolo POP3 é um protocolo antigo que, por padrão, exclui a mensagem após ela ter sido lida. O SE Suite não suporta a utilização da autenticação oAuth 2.0 (obrigatória para as contas de e-mail da Microsoft e do Google) com o protocolo POP3.
  • Endereço do servidor: Informe o endereço do servidor.
  • Porta: Informe a porta do servidor.
  • Usuário/Senha (visível com a autenticação básica): Informe o usuário e a senha da conta que terá os e-mails capturados. Utilize o botão Testar para verificar a conexão com o servidor.
  • Client ID: Código de identificação da aplicação no servidor de e-mail no qual está configurada a autenticação oAuth 2.0. 
  • Secret ID: Valor da credencial para acesso à caixa postal da conta de e-mail. Este valor pode ser visto no portal do servidor apenas no momento da criação da credencial.
  • Usuário: Conta de e-mail que será monitorada (necessário incluir o domínio).
  • Access Token: Código de autorização utilizado para realizar a autenticação da conta de e-mail. Para gerá-lo, é necessário clicar no botão Gerar novo token para ser aberta uma janela de login da própria Microsoft ou Google. Este token tem um tempo limite e pode ser utilizado uma única vez.
  • Desativar busca parcial de conteúdo MIME: Marque esta opção para que não seja utilizado o recurso de recuperação parcial de um conteúdo de e-mail do tipo MIME.

Durante configuração do oAuth 2.0 no portal da Microsoft ou Google, será necessário informar a URL que receberá o valor do Access Token. Este endereço deverá ser: “https://{CONTEXTO_SUITE}/se/workflow/gn_scheduling/inbox_processor/oauth_token.php”

O “CONTEXTO_SUITE” precisa ser substituído pelo endereço do servidor onde está o SoftExpert Suite. 

Por exemplo: "sesuite.softexpert.com"

 

Não será permitido o uso dos mesmos dados da configuração da caixa de entrada (Servidor e Usuário) em mais de um agendamento ativo. Somente será possível repetir os dados de um agendamento inativo.

 

Regras

Configure as operações que serão executadas pelo agendamento de importação de e-mail.

1. Para isso, clique no botão da barra de ferramentas lateral.

2. Na tela que será aberta, informe um nome para a regra.

O campo Sequência será automaticamente preenchido com a ordem de cadastro da regra, porém, quando houver outras regras já configuradas, esse sequencial poderá ser alterado.

A sequência define a ordem com que as regras serão processadas. Caso haja duas ou mais regras, a segunda regra somente será processada se a primeira regra falhar, a terceira regra somente será processada se a segunda regra falhar, e assim por diante. Ou seja, assim que for encontrada uma regra que possua as condições de aceitação do e-mail, o sistema irá executá-la e ignorar todas as demais regras seguintes.

O processamento das regras somente será finalizado assim que alguma regra não falhar (e ser executada), ou até que não haja mais regras para serem processadas.

Recomenda-se que regras mais complexas, como executar uma atividade, ou regras com condições muito específicas sejam as primeiras regras a serem processadas (valor sequencial mais baixo), enquanto regras mais fáceis de passar sejam as últimas da sequência.
 

3. Na aba Geral, preencha os seguintes campos:

Tipo de execução

Selecione a operação que será executada com a regra em questão:

  • Instanciar processo: Selecione esta opção para que a regra execute a inicialização do objeto configurado neste agendamento.
  • Incluir histórico: Selecione esta opção para que a regra inclua um registro no histórico do objeto configurado neste agendamento. Para aceitação das regras configuradas com esta ação, o assunto da mensagem de e-mail deve conter o identificador da instância entre os caracteres "<<" e ">>". Ex.: "Aprovação do chamado <<000011>> conforme combinado".
  • Executar atividade: Selecione esta opção para que a regra execute uma ação de uma atividade do objeto configurado neste agendamento. Em seguida, selecione a atividade a ser executada no campo Atividade de execução e selecione, no campo Ação a ser executada, qual ação será executada na atividade. Para aceitação das regras configuradas com esta ação, o assunto da mensagem de e-mail deve conter o identificador da instância entre os caracteres "<<" e ">>". Ex.: "Aprovação do chamado <<000011>> conforme combinado".

 

Processo/Tipo de Workflow

Esta seção será habilitada se a opção "Instanciar processo" estiver selecionada no campo Tipo de execução:

  • Processo: Selecione o processo que será inicializado pela regra.
  • Tipo de Workflow:  Selecione o tipo de workflow que será inicializado pela regra.
  • Iniciador padrão: Selecione o usuário que será considerado o iniciador da instância.
  • Definir o remetente como Iniciador caso ele seja um usuário cadastrado: Marque esta opção para que o remetente da mensagem importada seja o iniciador do processo, caso exista um usuário cadastrado com o mesmo endereço de e-mail do remetente. Caso não exista um usuário ou o remetente não possua permissão para instanciar o processo, o iniciador padrão será definido como iniciador do processo.
  • Atributo para armazenar o remetente: Selecione o atributo do processo que irá armazenar o e-mail do remetente da mensagem.

 

Execução

Esta seção será habilitada se a opção "Executar atividade" estiver selecionada no campo Tipo de execução:

  • Atividade de execução: Este campo somente ficará habilitado se a opção "Executar atividade" estiver selecionada no campo Tipo de execução. Sendo assim, selecione a atividade do objeto que será executada.
  • Ação a ser executada: Este campo somente ficará habilitado se a opção "Executar atividade" estiver selecionada no campo Tipo de execução. Sendo assim, selecione a ação para a execução da atividade do objeto.

 

Validar se o remetente é um usuário com permissão de execução

Esta opção somente ficará habilitada se a opção "Executar atividade" estiver selecionada no campo Tipo de execução. Marque esta opção para que a atividade somente seja executada caso o remetente do e-mail seja responsável pela execução da atividade, ou seja, para que o sistema verifique, através do endereço do e-mail do remetente, se ele é o executor da atividade.

 

Utilizar condições para a execução da regra

Marque esta opção para que esta regra somente seja executada quando uma das seguintes situações forem válidas:

  • Executar regra somente se todas as condições forem válidas: Marque esta opção para que a regra em questão seja executada somente se todas as demais regras forem válidas.
  • Executar regra quando qualquer condição for válida: Marque esta opção para que a regra em questão seja executada quando ao menos uma das demais regras for válida.
     

4. Se a opção Utilizar condições para execução da regra tiver sido selecionada, a aba Condições ficará habilitada.

Clique no botão para adicionar uma condição. Na tela que será aberta, preencha os seguintes campos:

  • Sequência: Este campo será preenchido automaticamente pelo sistema com a ordem da condição que está sendo cadastrada, porém, se houver outros registros de condições, esse valor poderá ser alterado.
  • Origem: Defina a origem da condição que será testada: Remetente, Destinatários, Assunto, Conteúdo da mensagem, Data de envio, Prioridade ou Contém anexo.
  • Operador: Selecione o operador a ser utilizado para testar a condição: Igual a, Diferente de, Contém, Não contém, Está contido em, Não está contido em, Está vazio ou Não está vazio. Este campo ficará desabilitado se for selecionada a opção "Contém anexo" para a origem.
  • Valor fixo: Informe o valor que será utilizado pelo operador na origem. Este campo ficará desabilitado se for selecionada a opção "Contém anexo" para a origem ou se for selecionada a opção "Está vazio" ou "Não está vazio" para o operador.

Salve os dados da condição para que ela seja incluída na regra.
 

5. Salve os dados da regra.

 
 

Notificado

Nesta aba, defina os usuários que serão notificados por e-mail quando ocorrer algum erro na conexão com o servidor de e-mail durante a importação.

1. Para isso, clique no botão .

2. Na tela que será apresentada, no campo Notificar, selecione o tipo de grupo que classifica o destinatário do e-mail:

  • Área: Os usuários de determinada área da organização serão os destinatários.
  • Função: Os usuários que exercem determinada função na organização serão os destinatários.
  • Área/Função: Os usuários de uma determinada área da organização e que exercem uma função específica serão os destinatários.
  • Usuário: Um usuário específico será o destinatário.
  • Equipe: Os membros de uma equipe cadastrada no sistema serão os destinatários do e-mail.

3. Os Filtros ficarão habilitados para que os usuários sejam preenchidos de acordo com o grupo selecionado.

4. Clique no botão da parte superior da tela para realizar a busca pelos usuários. O resultado da busca será apresentado de acordo com a opção selecionada no campo Notificar e os valores informados nos filtros.

5. Selecione aqueles que serão destinatários do e-mail. Utilize as teclas SHIFT ou CTRL do teclado ou o check ao lado de cada item para selecionar mais de um registro por vez.

6. No campo Permissão, selecione a opção Permitir para que os usuários selecionados recebam as notificações por e-mail ou selecione a opção Negar para que eles não recebam.

7. Clique .

 
 

Caixa de entrada

Nesta aba, serão apresentados os e-mails que foram capturados pelo agendamento.

Os e-mails serão copiados para o sistema com o objetivo de se obter uma melhor performance e dar maior cobertura no monitoramento da importação de e-mails.

Essa aba também apresenta o status da captura dos e-mails e outras informações, abordadas a seguir, facilitando, assim, a leitura e monitoramento da importação:

  • Será possível visualizar as validações das regras aplicadas individualmente em cada mensagem dentro da caixa de entrada do agendamento.
  • Serão exibidas as condições validadas contendo os parâmetros configurados na regra e o valor correspondente verificado na mensagem.
  • As regras de execução de atividade e inclusão no histórico mostrarão uma mensagem de erro quando não for encontrado o identificador da instância no assunto.
  • Processos configurados incorretamente deverão mostrar, de forma intuitiva, o aviso no histórico de agendamento e na validação da mensagem de e-mail.
  • Permite o reprocessamento manual de mensagens rejeitadas ou que tiveram erro na importação.
 
 

6. Salve a seleção dos campos para que o registro seja incluído no agendamento.

Posteriormente, a aba Histórico apresentará os logs das execuções realizadas. Utilize os campos Situação, Data início e Data fim para filtrar os registros de log. Utilize o botão para visualizar os detalhes do registro de log.

 

 

Conclusão

A execução é realizada conforme a frequência de recorrência configurada na aba Geral.

Ao salvar o registro pela primeira vez, o sistema realizará a verificação da conta e captura dos e-mails de acordo com as configurações realizadas anteriormente.


Este artigo foi útil?